Night Owl 6

home *** CD-ROM | disk | FTP | other *** search

/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 019a / zce12.zip / ZCE.HLP < prev next >

Wrap

Text File | 1991-12-09 | 33KB | 759 lines

3.1 ZCE Command Line Examples ZCE By itself on the command line will search the current directory for *.ZIP and display one screen of filenames and Comments sorted by filename. ZCE FOO* ZCE will search for FOO*.ZIP in the current directory ZCE A: ZCE will search drive a: for *.ZIP ZCE C:\DOS ZCE will search for a directory called DOS. If the directory DOS exists then ZCE will search for C:\DOS\*.ZIP. If the directory does not exist then ZCE will look for the filename of DOS. Once ZCE determines that the input filename specification is legal ZCE will display a window showing the Zip files being searched for Comments. Escape may be pressed to interrupt ZCE while reading Comments. A query box will be displayed to continue reading Zip Comments. Valid responses are: Y/N for Yes or No Arrow keys move highlighted response. Enter selects Left mouse button click on item if a mouse is detected. ZCE will display an error message if the command line arguments are invalid or if there is a problems opening or reading the files found. The error will indicate the problem. 3.2 ZCE Command line syntax and switches Zip Comment Editor Syntax, ZCE <drive:\path\filenames> [/options] Drive must be a Valid Dos Drive, i.e. A: or B: or C: Path must be in Valid Dos syntax, i.e. \dos\ or \wp50\letters\ Filenames may contain Wildcards, i.e. *.ZIP or H? 3.3 ZCE Command Line Display Options /M Force monochrome display /EGA Display 43/50 lines if EGA or VGA detected. /NS Do not restore original dos screen /? Display command line switches both / and - may be used for ZCE and ZD command line switches. 3.4 Example ZCE Screen Disk space Volume Label Date | | Version | Time | Drive | Monitor | | | | | | | +-----------------------------------------------------------------------+ |Zip Comment Editor vdoc_ver 10/26/91 5:27pm 14.6M E: QUICKBASIC VGA | +-----------------------------------------------------------------------+ |BACKUP.ZIP |Backup of c:\dos\ 10/24/90 | |TEST100.ZIP |$$$ Zip Comment to Long, Not Found or Zip Corrupted $$$ | |TEST101.ZIP | | |VIDEO.ZIP | | | | | +-----------------------------------------------------------------------+ |F1=Help F2=Read F3=Save F4=Read F5=Copy F6=Import F7=Vol F8=Dos ... | +-----------------------------------------------------------------------+ ZCE will display the names of Zip files being scanned for Comments or an error message if a problem occurs. ZCE will display in color or monochrome and 25, 43 or 50 lines if the appropriate video card is detected. ZCE will automatically tag all files with blank Comments for other functions described later. All Zip files detected will be displayed on the left side with Zip Comments on the right. The comment will have all control characters removed and truncated to 65 characters. If you want to preserve any Zip comment, simply do not edit the comment. ZCE will only write modified Comments. If ZCE had trouble locating the Zip comment, the message, $$$ Zip Comment to Long, Not Found or Zip Corrupted $$$ will be displayed as the comment. Bad Zip file Comments may not be edited or saved. Either the Zip file is corrupted or the Zip comment is very long. ZCE only reads the last 2024 bytes of the file to find the comment. Usually deleting the Zip comment will allow ZCE to read it correctly. Use the -Z command in PKZIP to delete the Zip comment. See ZIPFIX.BAT for an automated way to remove Comments from all Zip files in a directory. If you do this while in the dos shell make sure you execute the re-read Zip Comments command <F2> when you return to ZCE!!! Make sure you have written out all modified Comments first! See Shell command. ZCE will check each file size for any changes and display an error message if a change is detected. A Function key list will be displayed on the bottom line of the screen. 3.5 ZCE Main Window Editing Keys Insert Toggles the insert mode and over-type mode Delete Delete character at cursor Backspace Destructive backspace Left Move the cursor to the left Right Move the cursor to the right Up Move cursor to the next comment Down Move the cursor to the previous comment Return Same as Down Arrow Home Move the cursor to the beginning of the field End Move the cursor to the end of the field ^Home Move cursor to the start and erase the field ^End Erase from the cursor to the end of the field ^BackSpace Erase from the cursor to the start of the field @Home Scroll to top comment @End Scroll to bottom comment Tab Restore comment, until up/down move 4.0 ZCE Commands 4.1 F1 = On Line Help Window Functions ZCE will search for the file ZCE.HLP in the current directory and all directories in the current dos path. If the help file is not found an error message will be displayed otherwise the help file will be displayed. PgUp Scrolls up one page PgDn Scrolls down one page Up Scrolls up one line Down Scrolls down one line Left Sweeps left 15 characters Right Sweeps right 15 characters Home Go to far left column ^Home Go to top of file Escape Exit Help Mouse: Next Page Click the left mouse button on <PgDn>. Previous Page Click the left mouse button on <PgUp>. Next Line Click left mouse button on the Down Arrow. Previous Line Click left mouse button on the Up Arrow. Move Pointer The position marker in the scroll bar approximates the position within the help file. To move to another relative position, place mouse cursor on scroll bar position marker and press left mouse button. First Page Click left mouse on <^HOME>. Exit Click right mouse button. 4.2 F2 = Re-Read Zip Comments This command causes ZCE to read Comments from Zip files using the current drive, path and file specifications. This command allows you to read a new disk without exiting ZCE. If any Comments have been modified ZCE will warn you to save them or lose all changes. 4.3 F3 = Save Zip Comments This command saves any modified comment to the file from the drive and path it was read from. Any errors encountered will cause ZCE to display an error message of the problem. ZCE verifies all data writes and checks all file sizes for changes before writing. ZCE will not change file dates or times. 4.4 F4 = New File Specification & Read Comments An input prompt window will pop up requesting a new file specification. ZCE will then check this entry and give errors if the input could not be parsed or if files could be found. Wildcard characters are accepted. i.e. * or *.Zip or c:\dos\app? are all valid examples. ZCE will display an error if an invalid drive, path or file specification are entered. Pressing escape will cancel this command. The same rules apply here as the command line file specification when starting ZCE. 4.5 F5 = Copy Comment from Another File If more than one file comment is available in the main ZCE window, ZCE will pop up a list of current Comments which may be used for the current file comment. Use the arrow keys and press enter to select. Escape will abort this command. Home/End keys will move highlight bar to the first/last items in the list. If a mouse is detected the mouse pointer will be displayed. Move the mouse pointer to an item and select using the left button. The right mouse button or pressing escape will abort this command. 4.6 F6 = Import Zip Comments from a File This command searches a file for Zip file Comments. The search routine will use the filenames without extension as the search strings. Filenames like TEST or VIDEO may be found hundreds of times in a single file. It is best to manually add Comments to common filenames. Searching list may consist of ALL or Tagged filenames. There are two different modes to search a file for Comments. Edit mode will search the import file for a match and if found an edit screen window will pop and allow editing of the comment. Auto mode searches as in Edit mode but Comments are automatically extracted using the starting comment column as the left column of the comment. Auto mode only works if the filename and comment are on the same line. If a comment exists and a new comment is found in Edit or Auto mode a pop up window will appear for you to choose one. 4.6.1 ZCE Import Configuration File Example import screen: ┌[ Import Comments from a File ]─────────────────────────────────────────┐ │ │ │ Config File: ZCE.CFG░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ │ │ │ │ Comments File: BBS.LOG │ │ │ │ Col: 30 Comment Edit/Auto: E Tagged/All: T Input Buffer: 128 │ │ │ │ │ │ │ └────────────────────────────────────────────────────────────────────────┘ 4.6.2 Import Commands F1 Help F4 Add Filename to Import File List if less than 9. F5 Select Current Import File List F8 Save Settings file F9 Read Settings file F10 Start Import 4.6.3 Import Field Commands PgUp Move to the first field PgDn Move to the last field Up Move up one field Down Move down one field Left Move left one field Right Move right one field Home Move to the beginning of the field End Move to the end of the field Insert Toggle between insert and overstrike mode Del Delete the character under the cursor BackSpace Delete the character to the left of the cursor ^Right Move right one word ^Left Move left one word ^End Delete from the cursor to the end of the field Enter Move to the next field Tab Move to the next field #Tab Move to the previous field Escape Abort Import function Mouse: Left Move to position in field Right Abort Import function 4.6.4 Import Configuration Filename & Syntax The file ZCE.CFG contains the default import configuration. ZCE will search the current directory and all directories in the Dos Path for the file ZCE.CFG. If not found an error message will be displayed and default values will be assigned. ZCE.CFG Import configuration file syntax and defaults. start_col=30 edit/auto=E tag/all=T current_comments_file=FOO.BAR comments_file1=C:\DOS\BBS.LOG comments_file2=C:\DOS\BBS.ZIP,TEST.LOG comments_file#=filename.zip,filename comments_file#=filename import_buffer=256 Where # = 1 to 9 only, No Spaces Allowed. Compressed file must have a .ZIP extension and Import file must exist inside of the compressed file. 4.6.5 Import Comments Filename This is the filename of the file containing the Comments for import. This file must be in ascii format. If this filename is entered as a .Zip extension followed by a comma and another filename, ZCE will enter Zip Import mode. In Zip Import mode ZCE will try to uncompress the second file from the first and use the extracted file as the Import file. This may sound complicated but it really isn't. If C:\DOS\BBS.ZIP,TEST.LOG is entered as the Comments File then ZCE will create a subdirectory and call PKUNZIP.EXE to uncompress TEST.LOG. If successful the file TEST.LOG will be used as the Comments File. See View Compresses Zip File section for more details. This special option basically allows you to leave your BBS listings in compressed format and have ZCE temporally uncompress a copy to import Comments. NOTE: The only way to add as comma to the Comments file list is to type in a comma on the Comments File line and then press F4. A text editor may also be used to edit ZCE.CFG directly. 4.6.6 Import Starting Comment Column This number should indicate the starting column of the comment inside the Comments file. This option is only used for (A)UTO mode. 4.6.7 Import [E]dit/[A]uto This is the import type. E for EDIT and A for Automatic. ZCE can read single line Comments from a file in AUTOMATIC mode or up to 240 characters into a small line editor in EDIT mode. AUTOMATIC mode searches the Comments file for a line containing the filename portion like DOCS in DOCS.ZIP. This allows the ZCE to find Comments in all type of BBS (Bulletin Board System) file listings. ZCE will use the comment found on the first line that contains the filename string. This may not be the correct comment. Make sure you check the Comments after ZCE is finished. In EDIT mode (default) ZCE will pop up a line editor with three lines of data starting on the line that the filename is located. You can now edit the comment to your liking. Just remember that the finished comment must be no longer than 65 characters long. ZCE will truncate longer Comments. A marker is displayed at column 65 to indicate where truncation will occur. 4.6.8 Import Comment Search [T]agged/[A]ll Importing of Comments may be performed on tagged or all files. ZCE will only search for Comments of tagged files if T is entered. T is the default. This will speed up comment imports. 4.6.9 Import Editing Commands F1 Help Escape Skip the current comment and will keep the current filename on the search list. Enter Accept, Truncates the current comment to 65 characters and removes the filename from the search list. F10 Abort, Terminate Import function. ZCE will ask if you really want to Abort. ZCE will still use all previously found Comments even if Abort is selected. Insert Toggle between insert and overstrike mode Del Delete the character under the cursor BackSpace Delete the character to the left of the cursor ^Right Move right one word ^Left Move left one word ^End Delete from the cursor to the end of the field Enter Move to the next field Tab Move to the next field #Tab Move to the previous field Escape Abort Import function Mouse: Left Move to position in field Right Abort Import function 4.6.10 Import Buffer Size The Import buffer size is the number of lines read each time there is a search. This number my be from 32-384. The higher the number the faster ZCE cans search because of less disk activity. If there is not enough memory available ZCE will display an error message. Reducing the number of Zip files or reducing the import buffer size may allow ZCE to perform the import. MAIN ZCE Commands Continued 4.7 F7 = Volume Label If the current or selected drive is A: or B: then ZCE will pop up an input window for the new volume label. Only 11 characters will be allowed. ZCE will only allow characters that are valid for volume labels. 4.8 F8 = Dos Shell Spawns another COMMAND.COM leaving ZCE in memory. About 200K is used by ZCE. If the system crashes or is re-booted all editing of Comments will be lost unless saved. The prompt is modified to remind you to type EXIT to return to ZCE. Enter 'EXIT' to Return to ZCE C:\QB\ZCE> If you Shell to Dos and modify a Zip file in any way or delete files from the Zip File inside the View Zip function, the comment location in the file will be altered and ZCE will display an error message. At this point the modified comment can never be saved. Whenever you return to ZCE from the shell always re-read the Zip file Comments using the <F2> key if any Zip files were modified. Make sure you write out any modified Comments first! This will update comment positions to ZCE and allow correct comment update. 4.9 F9 = Tag/Untag file for Import This function will Tag or Untag a file. The Import function allows importing Comments for all or tagged files. 4.10 F10, Pull Down Menu If F10 is pressed in the main ZCE window a pull down menu will appear. The Pull Down Menu uses about 2000 bytes if string space. Pull Down Menu Keys: Down-Arrow Pulls down a window if one is not already down. Otherwise, it moves the highlight bar down one selection within the window. Up-Arrow Moves the selection bar up one item within a window. If a window is not pulled down, this key has no function. Left-Arrow If a window is not pulled down, the selection bar is moved to the next bar item to the left. If a window is pulled down, the window under the next bar menu item on the left is pulled down. Right-Arrow If a window is not pulled down, the selection bar is moved to the next bar item to the right. If a window is pulled down, the window under the next bar menu item on the right is pulled down. Alt-Highlighted Key If no windows are pulled down, holding down the Alt key while pressing a key highlighted on the menu bar will pull down the window under that item. Highlighted key If a window is pulled down, pressing a highlighted key will select that item in the menu. Escape If a window is pulled down, it will be erased and only the bar menu and the description line will be active. If a window is not pulled down, the pulldown menu will be exited. Enter If a window is not currently pulled down, the window under the highlighted bar menu item will be displayed. If a window is pulled down, the highlighted item within the window will be selected. Mouse Clicking the left button on a bar menu item will pull down the window for that item. Clicking the left button on an item within a window will select that item. Clicking the right button will exit the pull down menu. Pulldown menu contents: File Comment ┌──────────────────────┐ ┌──────────────────────┐ │ Help F1 │ │ Copy F5 │ │ Read F2 │ │ Restore Comment Tab │ │ Save F3 │ └──────────────────────┘ │ New FileSpec F4 │ │ Import F6 │ Tag │ voLume F7 │ ┌──────────────────────┐ │ Dos Shell F8 │ │ Tag cUrrent F9 │ │ Write Ctrl+F3 │ │ Tag All Ctrl+F9 │ │ reName Ctrl+F4 │ │ Tag Empty Ctrl+F2 │ │ View Ctrl+Enter │ └──────────────────────┘ │ eXit Escape │ └──────────────────────┘ Options ┌──────────────────────┐ │ Status Ctrl+F1 │ │ Display Ctrl+F5 │ └──────────────────────┘ 4.11 Escape, Exit ZCE A message will be displayed asking if you would like to exit ZCE. Default is NO. Arrow keys move between No and YES. The enter key will select. Y or N will also select. If you have a mouse the left button may be used to click on the Y or N. 4.12 Tab, Restore Comment This command will restore the current comment only if the cursor is not moved to another comment. i.e. up or down. 4.13 Ctrl+F1, ZCE Status Screen This command will display the internal ZCE variables. This command is mainly used for development of ZCE. I am documenting this just in case you run into it. 4.14 Ctrl+F2, Tag Files with Blank Comments This command will tag all files with blank Comments. 4.15 Ctrl+F3, Write Filenames and Comments This command will write tagged filenames and Comments to a user specified file. A filename input window will pop up requesting the file to write the filenames and comments. If the file exists or if problems occurred while writing the data to the file error messages will be displayed. The output file is formatted with filename and comment on the same line as they appear in ZCE. Many programs can use this file to as input into other database's. i.e. BBS file lists. 4.16 Ctrl+F4, Change Filename This command allows you to change the current filename. A pop up input window will appear prompting for new filename. Only characters valid for filenames will be allowed. If successful the filename will be changed. An error message will be displayed if the rename was not successful. 4.17 Ctrl+F5, Change Video Mode This command toggles between 25/43/50 line mode if ZCE detects that your graphics card supports these modes. 4.18 Ctrl+F9, Tag/Untag All Filenames All files will be tagged or untagged unless they have been displayed as bad or unfound. 4.19 Ctrl+Enter, View Compressed Zip File Contents If Ctrl+Enter is pressed the current Zip file will be scanned for all files. A Pick List will be displayed of all files found. If a file is selected by pressing enter, a subdirectory named $%ZCE&# will be created under the current directory. An optional environment variable ZCEWORK may be set to a directory and will be used instead of the current directory. This has two benefits. This directory may be a ramdisk or a drive with more space available. i.e. at the command line type the following or add to Autoexec.bat. set ZCEWORK=g:\ If this directory g:\ is a valid dos drive and directory ZCE will create the temporary there. This allows ZCE to use a ramdisk. PKUNZIP.EXE will be called to extract the chosen file, then LIST.COM will be called to display the file. Once LIST is finished, control will be returned to ZCE. Both PKUNZIP.EXE and LIST.COM must be in a directory in the DOS path. ZCE will display errors if the subdirectory and temporary file could not be created or removed and if PKUNZIP.EXE or LIST.COM could not be found in the DOS path. LIST.COM is the most powerful and widely used shareware file listing program available. Please read the LIST documentation for operation details. Look for it on your local BBS. Recursive Zip viewing is not supported. This means that selecting a Zip file inside a Zip file will not list a second list but only extract and display the Zip file in binary. When in the Dos Shell there must be enough memory to execute PKZIP, PKUNZIP and LIST programs. Other Zip View Compressed Commands: F1 On Line Help E Extract highlighted file to current directory Ctrl+E Extract tagged files to current directory D Delete highlighted file from current Zip file Ctrl+D Delete tagged files from current Zip file SpaceBar Tag/Untag highlighted file S Sort by [D]ate, [E]xtension, [F]ilename or [P]ath. Press D, E, F or P. Escape aborts the sort function. Right Mouse Tag/Untag current file Left Mouse Exit View Zip Example View Compressed Zip file listing: Filename Compressed Size Compression Method / / / / Original Size / Date Time / Path Scroll Bar / / / / / / / / ┌──────────────────────────────────────────────────────────────────┐ │ 25 .BAT 26 26 Sep-30-91 12:21 Stored DOS/ ░ │ 43 .BAT 15 15 Sep-05-91 13:10 Stored DOS/ ▓ │ 50 .BAT 26 26 Sep-05-91 13:10 Stored DOS/ ░ │ A2ZIP .BAT 138 105 Sep-05-91 13:10 Shrunk DOS/ ░ │ ARC2LZH .BAT 287 225 Sep-05-91 13:10 Shrunk DOS/ ░ │ ARC2ZIPA.BAT 564 290 Sep-05-91 13:10 Imploded DOS/ ░ │ ASK .BAT 37 37 Sep-05-91 13:10 Stored DOS/ ░ │ AUTOEXEC.BAT 749 418 Nov-18-91 7:29 Imploded ░ │ BACKUP .BAT 714 356 Jun-26-91 3:00 Imploded FB/ ░ │ BAT .BAT 5 5 Apr-18-91 17:48 Stored XTG/ ░ │ BBSLOG .BAT 62 59 Sep-05-91 13:10 Shrunk DOS/ ░ │ BD-PIF .BAK 416 121 Oct-04-91 13:07 Imploded QEMM/ ░ │ CALC .BAT 60 59 Sep-05-91 13:10 Shrunk DOS/ ░ │ CASE1 .BAT 387 264 Sep-05-91 13:10 Imploded DOS/ ░ │ CLOSED .BAT 57 56 Nov-08-91 7:32 Shrunk DOS/ ░ │ COM .BAT 5 5 Apr-18-91 17:48 Stored XTG/ ░ │ COMSPEC .BAT 146 119 Sep-27-91 7:25 Shrunk DOS/ ░ │ CONF .BAT 24 24 Jul-22-91 9:34 Stored FB/ ░ └──────────────────────────────────────────────────────────────────┘ If the path is to long to fit on the display the original and compressed file sizes will be removed from the display list. ┌──────────────────────────────────────────────────────────────────────┐ │ FOO . Nov-19-91 9:44 Stored QB/ZCE/ ░ │ FOO .BAT Sep-25-91 11:29 Stored QB/RFP/ ▓ │ TEST .BAK Nov-19-91 10:28 Stored QB/ZCE/REALLY/LONG/PATH/LONG/ ░ │ TEST .BAK Oct-26-91 15:58 Imploded QB/ZCE/DOC/ ░ │ TEST .BAS Apr-09-91 7:19 Imploded PBCLON14/ ░ │ TEST .BAS Sep-25-91 14:09 Imploded QB/RFP/ ░ │ TEST .BAT Jun-04-91 14:12 Stored QB/ZCE/TEST/ ░ │ TEST .BAT Oct-26-91 16:17 Shrunk QB/ZCE/ ░ │ TEST .BAT Sep-25-91 7:54 Stored QB/RFP/ ░ │ TEST .BQL Apr-09-91 7:20 Shrunk PBCLON14/ ░ │ TEST .BQL Sep-25-91 11:20 Shrunk QB/RFP/ ░ │ TEST .DEC Sep-25-91 11:19 Imploded QB/RFP/ ░ │ TEST .DOC Oct-18-91 9:38 Shrunk QB/ZCE/ ░ │ TEST .DOC Oct-26-91 15:59 Imploded QB/ZCE/DOC/ ░ │ TEST .EXE Sep-25-91 13:31 Imploded QB/RFP/ ░ │ TEST .EXT Sep-25-91 11:20 Imploded QB/RFP/ ░ │ TEST .LNK Sep-25-91 10:05 Shrunk QB/RFP/ ░ │ TEST .OBJ Sep-25-91 13:31 Imploded QB/RFP/ ░ └──────────────────────────────────────────────────────────────────────┘ View Compressed file commands when ZCE shells to DOS and executes PKZIP, PKUNZIP or LIST. View Zip File, Enter PKUNZIP -O ZIPFILE DIR\FILE Where -O overwrites any existing file with the same name. ZIPFILE is the name of the Zip file to be uncompressed by PKUNZIP. DIR is the path stored inside the Zip file. FILE is the name of the file that is uncompressed. LIST DIR\FILE Where DIR defaults to $%ZCE&#. If the ZCEWORK environment variable is set then this will be prepended to the $%ZCE&# directory. i.e LIST K:\WORK\$%ZCE&#\FILE if ZCEWORK is set to K:\WORK. FILE is the name of the file to view and the same as the file unzipped above. Delete File, D PKZIP -D ZIPFILE PATH\FILE Where -D stands for delete file. ZIPFILE is the name of the Zip file the file will be deleted from. PATH is the OPTIONAL path stored inside the Zip file and FILE is the name of the file to be deleted. Extract Tagged Files, Ctrl+E PKUNZIP ZIPFILE @ZCE.$$$ Where ZIPFILE is the name of the Zip file to be uncompressed. ZCE.$$$ is the file created in the local directory containing a list of tagged files to be extracted. Delete Tagged Files, Ctrl+D PKZIP -D ZIPFILE @ZCE.$$$ Where ZIPFILE is the name of the Zip file to be modified. ZCE.$$$ is the file created in the local directory containing a list of files to be deleted. Extract File, E PKUNZIP -O ZIPFILE DIR\FILE Where -O stands for overwrite existing file with same name. ZIPFILE is the name of the Zip file the selected file will be extracted from. PATH is the optional path stored inside the Zip file and FILE is the name of the file to be extracted.